C - SCRIPT LANGUAGE

Centipede has a simple scripting language, which is compiled within the Script
Editor utility. The following explains each of the scripting commands
available.


support = device,"prefix:","command1","command2"
support = 0
support = default

Set the current support files location for use in all the remaining commands in
the script, or until the next support= command. Command2 is optional. Setting
to 0 or default sets the location of the support files to the default support
files location. If the support= command is never used in a script, default is
assumed.


program = device,"prefix:","command1","command2"
program = 0
program = default

Set the current program files location for use in all the remaining commands in
the script, or until the next program= command. Command2 is optional. Setting
to 0 or default sets the location of the program files to the default program
files location. If the program= command is never used in a script, default is
assumed.


run #routine in "filename" as "command name" with
kill= no/none/dim/array/var/variable/all and
gfx= any/ascii/ansi/ibm/commodore/c=
at level lv
prompt
lock

Run the subroutine number routine in the module, overlay, or variable file
filename. All other syntax is optional. The words in, as, with, kill, and, gfx,
at, level , and the equal signs are all optional and ignored. Their parameters
do have an effect if used though:

kill:                   Enter the type of killer to be used.
                        Default is all.  The following combinations
                        combinations are synonymous: no/none, dim/array,
                        var/variable/all.

gfx:                    Required graphics emulation mode. Default is any.
                        The following combinations are synonymous:any/ascii
                        ansi/ibm, commodore/c=

level:                  Required minimum access level. Default is 1.

prompt:                 Give the caller a yes/no prompt asking whether or not to
                        run this line of the script. The command name will be
                        the prompt.

lock:                   The lock flag will only allow one port to run this
                        routine on a multiplexed system.

Prompt "text",c

Displays the prompt text to the caller and waits for a 'Y' or 'N' key press.
The script will be aborted if the caller pressed the letter defined by c or
CONTROL-P.



Display "text"

Display the text to the screen. Simple MCI commands may be imbedded into the
text.


Read "filename" at level lv

Display the SEQ file filename from the support files location to anyone of
level lv or higher. The words at and level are optional. lv defaults to 0, thus
eliminating the level restriction.



ifport=nd, end
ifport=nd, skip n

This command is used by mutliplexed dual-port systems only.
If the current port number (0 or 1) is nd, then either abort the rest of the
script or skip the next n commands in the script.

Note: support= and program= lines do not count as commands when skipping!

